home *** CD-ROM | disk | FTP | other *** search
/ Aminet 23 / Aminet 23 (1998)(GTI - Schatztruhe)[!][Feb 1998].iso / Aminet / game / shoot / ADoom_0_2.readme < prev    next >
Text File  |  1998-01-12  |  8KB  |  229 lines
  1. Short:    Amiga port of DOOM v0.2
  2. Uploader: Peter McGavin  (p.mcgavin@irl.cri.nz)
  3. Type:     game/shoot
  4. Uploader: Peter McGavin  (p.mcgavin@irl.cri.nz)
  5. Action:   NoStart
  6.  
  7.  
  8.  
  9.                             ADoom  0.2                      1 Jan 1998
  10.                             ----------
  11.  
  12.  
  13. This archive contains a preliminary Amiga port of DOOM, compiled as
  14. directly as possible from ID Software's Linux DOOM source code.
  15.  
  16. On 26th Dec 1997 I learnt that ID Software released the source code of
  17. DOOM and made it available by ftp.  So I immediately downloaded it and
  18. tried compiling it with SAS/C 6.58 for the Amiga.  This archive
  19. represents my results after about 5 evenings and 2 days.  Much of that
  20. time was spent tracking down 1 bug.  I need to go back to my real job
  21. soon...
  22.  
  23. Warning: This is an early version of ADoom with some limitations and
  24. bugs.
  25.  
  26. I included in this archive the source code of the Amiga-specific parts
  27. I wrote.  I did not include any of the original ID Software source
  28. code.
  29.  
  30. You can get the original ID Software Linux DOOM source from:
  31.  
  32.    ftp://ftp.cdrom.com/pub/idgames/idstuff/source/doomsrc.zip
  33.  
  34. See amiga_notes.txt for a detailed list of changes I made.
  35.  
  36. ADoom is OS-friendly and multitasks.
  37.  
  38. ADoom puts up an ASL requester for the ScreenMode.
  39.  
  40. Sound effects, ECS support and 68040-optimised C2P are included since
  41. version 0.1.  C2P is not optimised for 68020/68030, but it will work.
  42.  
  43. You can use a joystick in the 2nd gameport from v0.2.
  44.  
  45. AmiTCP network support was added in v0.2, but so far is rather
  46. unstable and slow, even with a direct ethernet connection between 2
  47. fast Amigas.
  48.  
  49. If disk loading of levels is very slow, try adding more disk buffers
  50. with the AmigaDOS ADDBUFFERS command.
  51.  
  52. There is another (different) Amiga DOOM port by Trance at
  53. "http://www.pluk.com/".
  54.  
  55.  
  56.  
  57. REQUIREMENTS:
  58. -------------
  59.  
  60. A 68020+ Amiga running at least OS 2.1, with at least about 8 Mb RAM.
  61.  
  62. A graphics card, CyberGraphics and 68040+ are strongly recommended,
  63. but ADoom should also work with AGA or ECS (EHB) using C2P.  I am
  64. currently unable to test AGA, but several users reported success.
  65.  
  66. --------------------------------------------------------------------
  67. | YOU NEED TO GET A WAD FILE THAT WORKS WITH LINUX DOOM AND PUT IT |
  68. | IN THE SAME DIRECTORY AS ADOOM.                                  |
  69. --------------------------------------------------------------------
  70.  
  71. Otherwise you get the message:  "Error: W_InitFiles: no files found"
  72.  
  73. WAD files typically have names like DOOM1.WAD and DOOM2.WAD.
  74.  
  75. Not all WAD files work.  It seems that some older WAD files are
  76. rejected because they leave out some information that ADoom requires.
  77. I think these same WAD files fail to work in Linux DOOM.  DOOM1.WAD
  78. from www.pluk.com works fine, as should the latest shareware WADs from
  79. ID Software's WWW site.
  80.  
  81. I use a stack size of 150000 bytes, but that's probably overkill.
  82. I don't know what the stack requirements really are yet.  It's
  83. probably less than 4096 bytes (because it worked OK from the icon
  84. when I forgot to set the stacksize).
  85.  
  86. An FPU is neither required nor used.
  87.  
  88. An MMU is neither required nor used.
  89.  
  90.  
  91.  
  92. LIMITATIONS:
  93. ------------
  94.  
  95. No mouse yet.
  96.  
  97. No joystick yet.
  98.  
  99. Very little Amiga-specific optimisation.
  100.  
  101. Play-tested for a few hours on an A3000 + WarpEngine + GVP Spectrum +
  102. Cybergraphics running OS3.1 and Enforcer, on which it seems to run
  103. very smoothly.  Many people reported success with ADoom v0.1.
  104. However, unfound bugs almost certainly exist.  In particular, ADoom
  105. sometimes seems to crash on exit.  Enforcer, mungwall and CPR don't
  106. seem to catch the crash.
  107.  
  108. Occasionally there is a level where all the monsters must be killed to
  109. complete the level.  There seems to be an outstanding bug that
  110. monsters kills are incorrectly counted.  Sometimes it is possible to
  111. complete the level without killing all the monsters.  Other times it
  112. seems impossible to complete the level.
  113.  
  114.  
  115.  
  116. KEYBOARD:
  117. ---------
  118.  
  119. Most keys are mapped the same as on a PC.  However the Amiga doesn't
  120. have F11, F12 and PAUSE keys.  On the Amiga, press '[' for F11, ']'
  121. for F12 and HELP for PAUSE.
  122.  
  123.  
  124.  
  125. NETWORKING WITH AMITCP:
  126. -----------------------
  127.  
  128. AmiTCP networking in ADoom is based on the Linux DOOM source code.  It
  129. works between Amigas and Linux PCs using TCP/IP on a fast network.  It
  130. uses TCP/IP on all computers, not IPX.
  131.  
  132. DOOM on PCs normally uses IPX for networking, which is incompatible
  133. with ADoom's TCP/IP.  I don't know whether there is a TCP/IP driver
  134. for DOOM on Windows95, but I heard there is such a thing for MSDOS
  135. (untested).
  136.  
  137. Currently ADoom probably won't work over serial lines with SLIP or
  138. PPP.  I tested it over ethernet and AmigaLink.  Even then it seemed
  139. rather jerky and slow, and it failed to start up when I tried crossing
  140. a gateway between the 2 networks.
  141.  
  142.  
  143. To start ADoom across 2 computers called fred and bob, say:
  144.  
  145.   1:  Make certain both computers are using identical WAD files;
  146.  
  147.   2:  Make certain you can PING fred from bob and vice versa;
  148.  
  149.   3:  On bob, enter:    "ADoom -net 1 fred"
  150.  
  151.   4:  On fred, enter:   "ADoom -net 2 bob"
  152.  
  153.  
  154. If there are 3 computers, called fred, bob and sue, say:
  155.  
  156.   1:  Make certain all 3 computers are using identical WAD files;
  157.  
  158.   2:  Make certain you can PING between all computers by name;
  159.  
  160.   3:  On bob, enter:    "ADoom -net 1 fred sue"
  161.  
  162.   4:  On fred, enter:   "ADoom -net 2 bob sue"
  163.  
  164.   5:  On sue, enter:    "ADoom -net 3 fred bob"
  165.  
  166.  
  167. It's normal for screens to go blank sometimes during the startup phase.
  168.  
  169. On Linux I used DOOM compiled from the source code available from:
  170.  
  171.    ftp://ftp.cdrom.com/pub/idgames/idstuff/source/doomsrc.zip
  172.  
  173.  
  174. I don't know whether other Linux DOOM implementations are compatible.
  175.  
  176. So far I have tested up to 3 computers.  The code is pretty untested
  177. and your mileage may vary.
  178.  
  179.  
  180.  
  181. BUGS FIXED:
  182. -----------
  183.  
  184. Early versions of ADoom required the HOME environment variable to be
  185. set.  This confused a lot of people.  Since version 0.2, ADoom saves
  186. its prefs file (.doomrc) in the current directory if HOME is not set.
  187.  
  188. Early versions of ADoom crashed if there wasn't enough memory
  189. available.  Since version 0.2, ADoom checks the result of the main (up
  190. to 6 Mb) memory allocation.  There are still a few places where small
  191. memory allocations are not checked.
  192.  
  193.  
  194.  
  195. THANKS:
  196. -------
  197.  
  198. Thanks to John Carmack and ID Software for one of the best games ever!
  199.  
  200.  
  201.  
  202. Peter McGavin.  (p.mcgavin@irl.cri.nz)
  203.  
  204.  
  205. ============================= Archive contents =============================
  206.  
  207. Original  Packed Ratio    Date     Time    Name
  208. -------- ------- ----- --------- --------  -------------
  209.     2100     285 86.4% 28-Dec-97 11:39:00  ADoom.info
  210.   334624  181126 45.8% 01-Jan-98 21:31:16 +ADoom
  211.      835     394 52.8% 28-Dec-97 11:35:20 +ADoom.info
  212.     6350    2845 55.1% 01-Jan-98 22:47:46 +ADoom.readme
  213.     2567     450 82.4% 28-Dec-97 11:35:52 +ADoom.readme.info
  214.     3063    1008 67.0% 28-Dec-97 14:22:58 +amiga_draw.s
  215.      460     225 51.0% 28-Dec-97 10:48:20 +amiga_fixed.s
  216.     1068     564 47.1% 30-Dec-97 17:40:46 +amiga_main.c
  217.     7282    2519 65.4% 29-Dec-97 17:14:28 +amiga_median.c
  218.       62      62  0.0% 29-Dec-97 16:07:08 +amiga_median.h
  219.     8193    2386 70.8% 01-Jan-98 21:30:56 +amiga_net.c
  220.     6593    2518 61.8% 01-Jan-98 22:10:08 +amiga_notes.txt
  221.    16809    5003 70.2% 30-Dec-97 19:08:34 +amiga_sound.c
  222.     4416    1519 65.6% 31-Dec-97 23:14:06 +amiga_system.c
  223.    16339    4281 73.7% 01-Jan-98 19:17:24 +amiga_video.c
  224.      551     162 70.5% 29-Dec-97 22:46:56 +c2p_040.h
  225.    10872    2154 80.1% 30-Dec-97 11:00:26 +c2p_040.s
  226.     2200     852 61.2% 01-Jan-98 19:15:12 +smakefile
  227. -------- ------- ----- --------- --------
  228.   424384  208353 50.9% 01-Jan-98 15:10:38   18 files
  229.